home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / WARD / SLIPDIAL / ReadMe < prev   
Text File  |  1995-11-14  |  6KB  |  168 lines
  1. Whats's it do?
  2. ==============
  3.  
  4. This archive just contains a set of hi-res sprites for SLIPdial. They
  5. include the various iconbar sprites, and a set of stack icons for use
  6. with Richard Birkett's excellent SlipSwitch script (available from cslib).
  7. The icons are based on Graham Allan's original sprites, with a slight
  8. Newerlook twist to them. I hope neither Graham nor DoggySoft mind!
  9.  
  10. Thanks also to Stephen Borrill for the information on patching the
  11. crunched version of SLIPdial 0.33.
  12.  
  13. OtherIcons is just a spritefile containing a couple of hi-res icons I
  14. knocked up (and bastardised from others :-) because I was fed up with
  15. the low-res ones.
  16.  
  17. Installation
  18. ============
  19.  
  20. First things first! *Make A Backup of the Original!* If you manage to
  21. break SLIPdial you're going to have BIG trouble getting online to get
  22. a new copy ;-)
  23.  
  24. This installation routine is slightly complicated by the fact that there
  25. are several versions of SLIPdial around, and unfortunately, the BASIC
  26. source needs slightly patching. The versions I know of, that this patch
  27. will work with are:
  28.  
  29. 0.33  --- distributed with the starter pack, and available from hensa.
  30. 0.34  --- I got this off ftp.demon.co.uk, I think. I don't think it's
  31.           available any more.
  32. 0.35a --- The latest version, available from cslib.ecs.soton.ac.uk
  33.  
  34. If your version is previous to 0.33 then I suggest you get a later version
  35. from any of the above mentioned ftp sites. Otherwise give me a mail if
  36. you can't work out what to do, and I'll see what I can sort out. Hopefully
  37. Graham will incorporate these icons into the next release.
  38.  
  39. Anyway, on with the installation:
  40.  
  41. 1) Ensure the newer option is not set in the options submenu of the Filer.
  42.  
  43. 2) Copy the new !SLIPdial application over the original. DO NOT DELETE THE
  44. ORIGINAL as I only distribute _my_ files in the archive !
  45.  
  46. 3) Now you will have to make a slight adjustment to the BASIC source to
  47. enable the program to load the correct spritefile for the screenmode you
  48. are in. This is much easier to do if the BASIC file hasn't been crunched
  49. (a process where all the variables etc. are made as short and meaningless
  50. as possible, so as to minimise the size of the file). If you got SLIPdial
  51. with the Internet Starter Pack you will NOT have the uncrunched source.
  52. The uncrunched source will be called '!RunimageS' (found inside !SLIPdial)
  53. while the crunched will be called '!Runimage'
  54.  
  55. What follows is a description of how to apply the patch for the differing
  56. versions of SLIPdial:
  57.  
  58. Uncrunched source (all versions)
  59. =================
  60.  
  61.  1) Load !RunimageS into an editor.
  62.  
  63.        a) For 0.33 ONLY find the line going 'sprsz%=&1B00'
  64.        b) For 0.33 ONLY change it to read 'sprsz%=&3000' to allow for larger
  65.                                                                  sprite file
  66.  For ALL versions ...
  67.  2) Find the line 'SYS "OS_SpriteOp",&109,sprites%'
  68.  3) After it add the following :
  69.  
  70.       REM *** Begin hi-res Sprites Patch ***
  71.       LOCAL sprExt$,n%,v%
  72.       sprExt$=""
  73.       SYS"Wimp_ReadSysInfo",2 TO n%;v%
  74.       IF (NOT(v%AND1)) THEN sprExt$=CHR$(n%?0)+CHR$(n%?1)
  75.       REM *** End Patch ***
  76.  
  77.  4) Then find the line (a couple of lines later) :
  78.  
  79.       IFFNmergesprites(sdres$+".Sprites")=THENERROR0,"Couldn't load sprites"
  80.  
  81.  5) And alter it to read:
  82.  
  83.       IFFNmergesprites(sdres$+".Sprites"+sprExt$)=0THENERROR0,"Couldn't load sprites"
  84.       REM                               ^^^^^^^^
  85.  
  86.  6) Save the file.
  87.  
  88.  7) At this point you can make a copy of this file and run it through a cruncher,
  89.     or you can just rename it to be !Runimage, and run it uncrunched. The Wimpslot
  90.     should be large enough for this, (well it is on my RiscPC though it will run
  91.     marginally quicker if you do crunch it.) [For some reason, If I crunch the
  92.     source with 'BasCrunch' the Runimage gets corrupted and won't run :-( ]
  93.  
  94.  8) If you are using 0.34 or above, load the !Run file and make sure the last
  95.     line reads
  96.  
  97.       Run <Obey$dir>.!Runimage -s 20000 %*0
  98.  
  99.       (or 'Run <Obey$dir>.!RunimageS -s 20000 %*0' if you want to run the uncrunched
  100.       version)
  101.  
  102.     This should allow enough space for the new icons. If you subsequently
  103.     get an error saying something like 'No Room for this Dim' then try
  104.     increasing the WimpSlot in the !Run file.
  105.  
  106. Crunched Source file (version 0.33 ONLY)
  107. ====================
  108.  
  109.  1) Load !SLIPDial.!Runimage into your favourite editor.
  110.  
  111.  2) Find the line:
  112.  
  113.      d_%=&1B00
  114.  
  115.     and change it to read:
  116.  
  117.      d_%=&3000
  118.  
  119.  3) Then find the line going:
  120.  
  121.      SYS46,&109,Ca%
  122.  
  123.  4) After it add the following:
  124.  
  125.       REM *** Begin hi-res Sprites Patch ***
  126.       LOCAL sprExt$,n%,v%
  127.       sprExt$=""
  128.       SYS"Wimp_ReadSysInfo",2 TO n%;v%
  129.       IF (NOT(v%AND1)) THEN sprExt$=CHR$(n%?0)+CHR$(n%?1)
  130.       REM *** End Patch ***
  131.  
  132. 4) And change the line going:
  133.  
  134.       IFFNDa(z`$+".Sprites")=0THENERROR0,"Couldn't load sprites"
  135.  
  136.    to read:
  137.  
  138.       IFFNDa(z`$+".Sprites"+sprExt$)=0THENERROR0,"Couldn't load sprites"
  139.       REM                   ^^^^^^^^
  140.  
  141. 5) Finally, save it.
  142.  
  143.  
  144. The End
  145. =======
  146.  
  147. That's it! Now SLIPdial will have lovely high resolution sprites on the iconbar,
  148. if you are in a hi-res screenmode. I've also included my TCP/IP stack indicators
  149. (In the Scripts directory) for use with scripts that can switch between
  150. KA9Q and Freenet etc. I made these quite narrow, as I find icon bar space to be
  151. a rapidly decreasing commodity even on a nice 17" monitor in 1200x1024
  152. [I guess I have too many toys :-) ]
  153.  
  154. If you want to get in touch for whatever reason feel free. My (present)
  155. email address is below. Be aware that this may change in the forseeable
  156. future.
  157.  
  158. Andy,
  159. 13th November 1995
  160.  
  161.                    *** Death to Low resolution Icons ! ***
  162.  
  163. Andy Ward                          |
  164. andy@websvcs.demon.co.uk           |   Connectiv Internet Consultants
  165. tel:  +44 (0)191 2211599           |   Newcastle-upon-Tyne,  UK
  166. fax:  +44 (0)191 2210428           |   http://www.connectiv.co.uk/
  167.  
  168.